home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / sebfi101.zip / SEBFI.DOC < prev    next >
Text File  |  1991-10-15  |  12KB  |  377 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                   Scanlon Enterprises Batch File Interpreter
  8.  
  9.  
  10.                                    S E B F I
  11.  
  12.                                    Ver. 1.01
  13.  
  14.  
  15.                                  (C) 1989-1991
  16.  
  17.                              (All rights reserved)
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                  B A T C H    F I L E    I N T E R P R E T E R
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                             U S E R    M A N U A L
  31.  
  32.  
  33.  
  34.  
  35.  
  36.        The shareware concept has made it possible for you to obtain 
  37.        extremely powerful software at a price you can afford, and it 
  38.        gives you the opportunity to try the software before you 
  39.        register. 
  40.   
  41.        Shareware is kept alive by YOUR support.
  42.  
  43.        Evaluate the program for 30-days and give copies to your friends 
  44.        for evaluation.  If, after the 30 days, you continue to use the 
  45.        program, then register it by sending us the registration form 
  46.        included in this file, plus the suggested registration fee.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.        This utility has some drawbacks to running a batch file using the 
  53.        Dos COMMAND.COM batch file handler.
  54.  
  55.        One, you will not be able to use errorlevels when executing built 
  56.        in Dos commands such as ECHO, SET, FOR, etc... or when executing 
  57.        externalfunctions such as our SEBFU utilities. Two, the use  of 
  58.        FOR (the Dos built in function) can not be used to execute our 
  59.        built in functions (more on this later). Three, the DOS GOTO 
  60.        command will not function to loop to another part of the batch 
  61.        file, instead, you must use our built in function GO (short for 
  62.        GOTO). All other DOS functions seem to function properly. SEBFI 
  63.        limits batch file size to 16K, which is a fairly large one, since 
  64.        rarely do batch files exceed 1K.
  65.  
  66.  
  67.        Why use this utility ? Well, we can guarantee at least a four 
  68.        fold increase in execution of batch files.  This is  accomplished 
  69.        by placing the entire batch file (limited to 16K) into memory  at 
  70.        once.   Since  we won't have to read each line from  a  disk,  or 
  71.        execute commands from a disk (except the external ones), we get a 
  72.        very significant increase in execution speed.
  73.  
  74.  
  75.        How do you use these utilities ?
  76.  
  77.        All of the regular Dos built in commands are available, these are
  78.  
  79.        BREAK     CD (CHDIR)     CLS       COPY      DATE      DEL
  80.        DIR       ECHO           EXIT      FOR       GOTO      IF
  81.        PATH      PAUSE          PROMPT    REM       REN       SET
  82.        TIME      TYPE           VER       VERIFY    VOL
  83.  
  84.        In  addition  to  these  Dos built  in  commands,  we  offer  the 
  85.        following built in ones :
  86.  
  87.        CL        Same as our CLR utility (SEBFU utility)
  88.        CM        Set or check video mode (uses built in errorlevel)
  89.        CT        Toggle cursor on or off
  90.        DM        Set built in errorlevel to day of month
  91.        DV        Sets the built in errorlevel equal to the drive number
  92.        DW        Set built in errorlevel to day of week
  93.        FF        Send form feed to PRN device
  94.        GA        Set built in errorlevel to alpha keystroke
  95.        GN        Set built in errorlevel to numeric keystroke
  96.        GO        Built in replacement for GOTO
  97.        HR        Set built in errorlevel equal to hour of day
  98.        IE        Replaces Dos IF ERRORLEVEL function (built in errorlev)
  99.        LC        Position cursor
  100.        MN        Set built in errorlevel equal to current minute
  101.        WR        Save as our WRITE command (SEBFU utility)
  102.        YR        Set built in errorlevel equal to the current year
  103.        YN        Set built in errorlevel in response to yes/no question
  104.  
  105.  
  106.        SEBFI INTERNAL COMMAND USAGE
  107.  
  108.  
  109.        CL sr sc er ec bc fc
  110.  
  111.        (user must supply the first 4 values)
  112.  
  113.        Where : 'sr' = start row of window
  114.                'sc' = start column of window
  115.                'er' = ending row of window
  116.                'ec' = ending column of window
  117.                'bc' = background color
  118.                'fc' = foreground color
  119.  
  120.  
  121.        Description: A window will be cleared, using the selected 
  122.        windowing area and colors. If the colors are NOT specified, the 
  123.        the current screen colors are used.
  124.  
  125.  
  126.        CM option val
  127.  
  128.        Where : 'option' is 'G' for get mode, and returns an errorlevel, 
  129.        using the IE function equal to the current video mode.
  130.                'option' is 'S' for set mode to the following 'val', 
  131.        which is a decimal value. The 'S' should be immediately followed 
  132.        by the value, IE... S5  will set the mode to 5.
  133.  
  134.  
  135.        Description: Sets or gets the video mode. When getting the mode 
  136.        using option 'G', the mode may be retrieved only by using the 
  137.        built in function 'IE'. When setting the mode, please follow the 
  138.        guidelines as stated above.
  139.  
  140.  
  141.        CT
  142.  
  143.        Description: Toggles the cursor between on and off. This function 
  144.        will toggle the cursor to it's opposite state, that is, if it is 
  145.        on, then it will be turned off.
  146.  
  147.  
  148.        DM
  149.  
  150.        Description: Returns an error level equal to the day of the 
  151.        month, which may be tested using the IE function
  152.  
  153.  
  154.        DV
  155.  
  156.        Description: Returns an errorlevel equal to the drive number, 
  157.        where 1=A and 26=Z. Use the IE function to test the value.
  158.  
  159.  
  160.  
  161.        DW
  162.  
  163.        Description: Returns an errorlevel equal to the day of the week. 
  164.        Use the IE function to test the value.
  165.  
  166.  
  167.        SEBFI INTERNAL COMMAND USAGE   {continued}
  168.  
  169.  
  170.        FF
  171.  
  172.        Description: Sends a form feed to the printer LPT1
  173.  
  174.  
  175.  
  176.        GA
  177.  
  178.        Description: Gets an alpha keystroke, returning an errorlevel 
  179.        equal to the alpha key, where 1=A and 26=Z. GA ignores the case 
  180.        of the alpha key pressed, so that 'a' also returns a 1 and 'z' 
  181.        also returns a 26. Use the IE function to test this errorlevel.
  182.  
  183.  
  184.  
  185.        GN 
  186.  
  187.        Description: Gets a numeric  keystroke, returning an errorlevel 
  188.        equal to the numeric key, where 0='0' and 9='9'. Use the IE 
  189.        function to test this errorlevel.
  190.  
  191.  
  192.        GO label
  193.  
  194.        Where : 'label' is any valid label, preceded by a colon
  195.  
  196.        Description: Branches to the the label 'label'
  197.  
  198.  
  199.        HR
  200.  
  201.        Description: Returns an errorlevel equal to the hour of the day, 
  202.        Use the IE function to test this errorlevel.
  203.  
  204.  
  205.        IE val command
  206.  
  207.        Where : 'val' is the value of the errorlevel to test for, in 
  208.        decimal, IE... if you want to test for errorlevel 9, then enter 
  209.        '9' as the 'val'.
  210.                'command' is any valid batch command recognized by this 
  211.        program (see above).
  212.  
  213.        Description: This is a very powerful function, and performs any 
  214.        other function based upon the result of the test being true. 
  215.        Thus, if the user tested for errorlevel=9 (IE 9) and the result 
  216.        is positive (true) then the 'command' would be performed.
  217.  
  218.  
  219.        SEBFI INTERNAL COMMAND USAGE   {continued}
  220.  
  221.  
  222.  
  223.        LC r c
  224.  
  225.        Where : 'r' is the row
  226.                'c' is the column
  227.  
  228.        Description: Positions the cursor to the value (in decimal) of 
  229.        'r' and 'c'. Thus, LC 5 5   would position the cursor on line 5, 
  230.        column 5.
  231.  
  232.  
  233.        MN Sets the built in errorlevel (recovered by using function IE), 
  234.        to the value of the current minute. IE... 10:45  sets the 
  235.        errorlevel to 45.
  236.  
  237.  
  238.        WR /LcRrXNCbf,message
  239.  
  240.        Where : '/'  Specifies start of the switches
  241.                'Lc' Sets the column to 'c'
  242.                'Rr' Sets the row to 'r'
  243.                'X'  Centers string on line (must use either this or L
  244.                                             not both)
  245.                'N'  Cursor is positioned to end of string 'message'
  246.                'Cb f' Sets the color, where 'b' is the background and 
  247.        'f' is the foreground. If NOT specified, the WR uses the current 
  248.        colors.
  249.  
  250.        Description: Displays text using color, a specified line